home *** CD-ROM | disk | FTP | other *** search
/ 101 OnLy ThE BeSt GaMeS 6 / 101 OnLy ThE BeSt GaMeS 6.iso / card / ginrummy / cribbage.doc < prev    next >
Encoding:
Text File  |  1996-01-03  |  23.2 KB  |  540 lines

  1. =====================
  2.  
  3.       Cribbage
  4.  
  5.         from
  6.  
  7.  Universal Software
  8.  
  9. ---------------------
  10.  
  11. Copyright (c) 1993-96
  12.  
  13.    David A. Teach
  14.  
  15. ---------------------
  16.  
  17.     Version 2.0
  18.  
  19. =====================
  20.  
  21.  
  22. Requirements / Recommendations to play  
  23. ======================================
  24.  
  25. Requires EGA, VGA, MDA, AT&T 400, PC 3270, or Hercules graphics system.
  26.  
  27. A Microsoft, Logitech, or compatible mouse is recommended.
  28. Three button rodents work better for the hint feature.
  29.  
  30. An IBM or compatible AT computer with 8 mHz or faster CPU speed is
  31. also recommended.
  32.  
  33.  
  34. How to play this computer game
  35. ==============================
  36.    When using the mouse, commands are selected with either the Left or
  37. Right mouse buttons.  When in keyboard mode, the numbers or letters for
  38. the commands are highlighted in light green; or on monochrome displays
  39. the appropriate key is bright white or underlined.
  40.  
  41.    When the information box pops up in the middle of the screen during
  42. play, it will stay on the screen for 5 seconds.  Hit any key or mouse
  43. button to clear it quicker.
  44.  
  45. ***** If the mouse cursor is not present in the Options, High Scores,
  46. or Statistics screens, then you have a problem with your mouse driver
  47. not accessing the second video page.  Get an updated mouse driver, or
  48. use the NOBLANK command line option to disable video paging.
  49.  
  50. ***** Monochrome EGA/VGA and/or 64k EGA users: If the colors don't come
  51. out correctly or if you cannot go to the Options or Stats screens, try
  52. using the LAPTOP command line parameter.  I set this up to force the 
  53. program into 2 color/1 video page on these systems.  With all other
  54. configurations the LAPTOP toggle works normally.
  55.  
  56.  
  57. The Title Screen:
  58.  
  59. BEGIN GAME -
  60.    Typing 'B' or clicking the left or right mouse button on the BEGIN
  61. GAME box starts the game with the shown options.  Hitting ENTER will
  62. also choose this.
  63.  
  64. OPTIONS -
  65.    Typing 'O' or clicking on OPTIONS will bring up the game Options
  66. Menu.  See "Options Menu" below for the list of options.
  67.  
  68. STATISTICS -
  69.    This displays the current player's cumulative game statistics.  Users
  70. of the keyboard hit the 'S' key.
  71.  
  72. QUIT -
  73.    QUIT will exit the program.  Type 'Q' from the keyboard.
  74.  
  75.  
  76. The Options Menu:
  77.  
  78. MAIN MENU -
  79.    This option will bring you back to the main menu. (Title screen)  You
  80. can hit the letter 'M' or the ENTER key to select this in keyboard mode.
  81.  
  82. NAME -
  83.    The default name is 'PLAYER'.  You can change this by typing 'N'     
  84. or clicking the mouse pointer within the red box around the name, typing
  85. a new name, and pressing ENTER (or a mouse button).  Backspace is the
  86. only editing key allowed if you make an error while typing in the name. 
  87. Upper and lower case letters, numbers 0 through 9, characters ! . , " -
  88. : / ? and spaces are also allowed.  The name can be a maximum of eight
  89. characters long.
  90.  
  91. SCORE LIMIT -
  92.    Clicking on SCORE LIMIT cycles the pegging board total between 121
  93. and 61 pegs.  Use either mouse button, or the + or - keys.
  94.  
  95. SKUNKING -
  96.    Changing the SKUNKING option to YES will allow a skunk win.  If a 
  97. player fails to reach the skunk point (limit - 30) with at least one peg
  98. by the end of a game, this counts a 2 wins.  When playing to 121 points,
  99. the skunk line is after the 90th hole; for a 61 point limit it is after
  100. the 30th.  This may also be called a "lurch" by some players.  Double
  101. skunk (halfway for 121 limit) is NOT implemented.  Hit the 'K' key from
  102. the keyboard to toggle skunking on or off.
  103.  
  104. BIG CARDS -
  105.    The default card set has more realistic-looking cards, but the suits
  106. may be a little small for some people to see clearly.  If this is so,
  107. or you just like the one pip better, changing this option to YES will
  108. give you cards with one big number and one big symbol for the suit.
  109. Hit the letter 'B' to switch this option to YES or NO.
  110.  
  111. POINTER -
  112.    Clicking on this option will change the shape of the mouse pointer. 
  113. There are seven different shapes to choose from.  Obviously, this will
  114. not have any effect if you are not using a mouse, but 'P' still toggles.
  115.  
  116. SAVE -
  117.    Selecting SAVE will save all options to the CRIBBAGE.CFG file.  This
  118. file is loaded when the program is run, so your name and your favorite
  119. options are already set.  If this file is not present, or is corrupted,
  120. it will be created with the default options.  At present, the NOBLANK
  121. option is not saved in this configuration file.  'S' from the keyboard.
  122.  
  123.  
  124. Player Statistics Screen:
  125.    Clicking within the Main Menu box will bring you back to the main
  126. menu. (Title screen)  You can hit the letter M or the ENTER key to
  127. select this in keyboard mode.
  128.  
  129.  
  130. Rules of the Game  -  Taken from "Official Rules of Card Games",
  131. =================     62nd edition, U.S Playing Card Company, 1968
  132.  
  133. Rank of cards:
  134.    (High) K, Q, J, 10, 9, 8, 7, 6, 5, 4, 3, 2, A.
  135.  
  136. The Deal:
  137.    Each player receives 6 cards.  The players then choose two cards to
  138. discard.  The four cards discarded by the two players constitute the
  139. CRIB, which always belongs to the dealer.
  140.  
  141.    After both players have discarded their two cards, the deck is cut
  142. and one card is placed face up from the deck.  This card is the STARTER.
  143. If the STARTER is a JACK then the dealer PEGS (scores) 2 points.
  144.  
  145. Game play:
  146.    After the STARTER has been turned, play begins with the non-dealer
  147. laying down a card face up on the table.  The dealer then next exposes
  148. a card with the play alternating between the two players, except for
  149. GO's as noted below.  Each time a player lays down a card he announces
  150. the sum of all the cards that have been laid down so far.
  151.  
  152.    During play, the sum can never exceed 31.  If a player cannot play a
  153. card without exceeding 31 he must say GO and his opponent pegs 1 point.
  154. Before pegging his 1 point the player gaining the GO must lay down all
  155. the cards he can without exceeding 31.  If a player reaches exactly 31
  156. then he pegs 2 points instead of 1 point for the GO.  The player who 
  157. said GO starts off the next round of play, and sum is reset to zero.
  158.  
  159.   The object in play is to score points by pegging.  In addition to the
  160. GO, a player may peg points in the following combinations:
  161.  
  162. Pegging Combinations:
  163.  
  164. FIFTEEN
  165.    You peg 2 points for adding a card that makes the sum equal to 15.
  166.  
  167. PAIR
  168.    You peg 2 points if you match the rank of the previously played card.
  169.  
  170. TRIPLET
  171.    Adding the third card (in a row) of the same rank scores 6 points.
  172.  
  173. FOUR
  174.    Adding the fourth card (in a row) of the same rank pegs 12 points.
  175.  
  176. RUN (Sequence)
  177.    For adding a card that forms with previously played cards a sequence
  178. of 3 or more, in any order, you peg 1 point for each card in the sequence.
  179. Runs are independent of suits and can be played in any order.
  180. Example: 3-4-5,  3-5-4,  5-2-4-3,  etc.
  181.  
  182.  
  183. Scoring Hands:
  184.    When play ends, the three hands are counted in order: non-dealer, then
  185. dealer's hand, then CRIB.  This order is important, since toward the end of
  186. a game a player might be able to reach a winning score before his opponent
  187. has a chance to count his hand.  The STARTER is considered a part of each
  188. hand, so all three hands contain five cards when scored.
  189.  
  190. The following describes the basic formations for scoring the hands:
  191.  
  192. FIFTEEN
  193.    2 points for each combination of cards that total 15.
  194.  
  195. PAIR
  196.    2 points for each pair of cards of the same rank.
  197.  
  198. RUN
  199.    Each combination of 3 or more cards in sequence counts 1 point for
  200. each card in the RUN.
  201.  
  202. FLUSH
  203.    Four cards of the same suit (not including the STARTER) is 4 points.
  204. If the STARTER is also the same suit, count 5 points instead of 4.
  205. Only a 5 card flush counts in the CRIB.
  206.  
  207. JACK
  208.    Holding a JACK of the same suit as the STARTER counts as 1 point.
  209.  
  210. **** Note: EACH and EVERY combination counts separately. ****
  211.  
  212. Example:
  213.    A hand (with STARTER) of 8,7,7,6,2 will score 16 points.  How ???
  214. For four combinations that total FIFTEEN: the 8 with one 7 and also with
  215. the other 7, and the 6-2 combined with the two 7s will score 8 points.
  216. It also scores 2 for the PAIR of 7s, and 6 points for the two RUNS of
  217. three: 8-7-6, using each 7 in turn.
  218.  
  219. (If you can't remember all this, don't worry; the computer does all the
  220. laying-off, counting, and rule enforcement for you.)
  221.  
  222.  
  223. Winning and Losing:
  224.    The game ends the moment a player reaches the agreed score limit
  225. whether by pegging or counting his hand.  Once a player reaches the
  226. last peg hole, no further points are counted.
  227.  
  228.  
  229. Hints -
  230.    The center button (recommended), or both left and right buttons 
  231. pressed simultaneously will ask the computer for a hint.  When using
  232. the keyboard, the letter H brings up the hint suggestion.
  233.  
  234. CAREFUL: If you are using both left and right mouse buttons to ask for
  235. hints, you must make sure that the mouse pointer is NOT OVER a regular
  236. choice area, (deck, card in hand, quit, etc.) or else the game will
  237. usually think that you made a normal choice with a single button.  If
  238. you have a center button, use that instead; this will work for hints
  239. ANYWHERE on the screen, even over normal choice areas.
  240.  
  241.    IF YOU HAVE A THREE BUTTON MOUSE, BUT THE CENTER BUTTON DOESN'T DO
  242. ANYTHING, you probably are using a different mouse driver than the one
  243. which came with your mouse.  A three button mouse MUST be driven by a
  244. three button mouse driver.  Most of the Microsoft mouse driver programs
  245. are for two button rodents.  They seem to work fine for all operations
  246. of the mouse except for the center button.  If you have a problem, look
  247. around the BBS's for a newer mouse driver, (I use Logitech mouse driver
  248. version 6.10) or contact the company where you purchased your mouse.
  249.  
  250.  
  251. The Screen Saver -
  252.    If no keyboard or mouse input is detected for a certain amount of
  253. time during the game, the screen will blank out to prevent burn-in.  The
  254. time limit for this is set by the game score limit.  The time of waiting
  255. is 5 minutes for a score limit of 61, and 10 minutes for a score limit of
  256. 121.  If your favorite score limit does not match your wanted screen saver
  257. time, learn to live with it.
  258.    To activate the screen blanker immediately, move the mouse cursor
  259. into the upper right hand corner and the screen will automatically blank
  260. out.  This can be handy for the traditional use of a "Boss key" function.
  261. In keyboard mode, the ESCAPE KEY is the activation key.
  262.  
  263. *** NOTE: NO SCREEN BLANKING WILL OCCUR IF THE NOBLANK OPTION IS ON. ***
  264.  
  265.  
  266. *** To get out of the blank screen, press any key or mouse button. ***
  267.  
  268.  
  269. The Statistics file -
  270.    Also at the end of each game, the program checks for a stats file
  271. called CRIBBAGE.STA in the current directory.  If it is not there, it 
  272. is created.  This file saves cumulative totals for average score in your
  273. hand and in your crib, the total number of games won and lost, the total
  274. number of hands played and the player's name.  If your stats file is
  275. corrupted, or you just want to clear the list and start over, erase (or
  276. rename) the CRIBBAGE.STA file.  You can have up to 20 different names
  277. currently running in this stats file.  If the current player name is not
  278. found in this file, it is added to the top of the file with zero totals.
  279. WARNING, if this addition makes more than 20 names, the name on the
  280. bottom of the list (the oldest) is truncated.
  281.  
  282. ******* If you quit a hand before the END of the game, the statistics
  283. file WILL NOT be updated for the hands that were played. *******
  284.  
  285. ******* If you are playing Cribbage on a write-protected or read-only
  286. drive, the stats will start from zero when you start the game; they will
  287. be kept for when you are in the program, but cannot be saved upon exit.
  288. Use the command line path function to read and save to a writable drive.
  289.  
  290.  
  291. Notes on the Computer player -
  292.    The computer does NOT "cheat" when playing.  It does not look at your
  293. crib when discarding, it does not look at your hand, or do any other
  294. thing that a human player cannot do.  The computer chooses its cards by
  295. a set of fixed formulas that do not have any room for human "intuition"
  296. or for many of the different possible arrangements of the hand that might
  297. make a good human player choose a different discard than the computer.
  298.  
  299.    The "Hint" function uses about the same formulas for choosing the
  300. player's card(s) that the computer uses for its moves.  This means that
  301. if you depend too heavily on the hints, you will end up winning only
  302. about half of your games.
  303.  
  304.  
  305. Command Line Options:
  306.    The default setting for the two options NAME and SCORE LIMIT can be
  307. set from the command line, overriding (but not overwriting) the
  308. configuration file settings.  This can be handy to set up some batch
  309. files for different players on one machine.
  310.  
  311. At the DOS prompt, you can do the following:
  312.  
  313. To get a quick help screen for the command line options, type CRIBBAGE 
  314. followed by /? or ? or help or HELP.  This must be the first parameter.
  315.  
  316. To list all of the contents of the statistics file from the DOS prompt,
  317. (in case you forget who is in there) type: CRIBBAGE list
  318.  
  319. To list the contents of this documentation file from the DOS prompt,
  320. (in case you can't view it any other way) type: CRIBBAGE view
  321.  
  322. **** NOTE: The previous three command line parameters (help, list, view)
  323. must be the FIRST parameter given, and all will exit to DOS when done.
  324.  
  325. To set the SCORE LIMIT, type: CRIBBAGE 61  or  CRIBBAGE 121
  326.  
  327. To have the game use your name instead of the default name, you can
  328. state it as a command line option.  ex. CRIBBAGE Dave
  329.  
  330. For the Command line option of Player Name, the length limit is 8 
  331. characters and the name must be ONE word.  You can use BobSmith, or
  332. Ron_Hill, etc., but typing Paul Schoenberger will give you Schoenbe for
  333. your name.  If you want a space in your name, you can put one in only
  334. with the Name Change from the options menu.
  335.  
  336. The name used is the LAST word on the command line that is NOT otherwise
  337. recognized as a command, so be sure not to have any gibberish on the
  338. line when you start the game: CRIBBAGE Mike ASDF  will make your name
  339. ASDF not Mike.  
  340.  
  341. NODISK
  342. This option will disable all disk access that the program uses.  That
  343. includes loading and saving both statistics and options.  All the options
  344. will be set to default when first running the program, and the statistics
  345. will still work for the current session (starting at zero), but will not
  346. be saved upon exit of the program (or when changing the player's name).
  347.  
  348. NOBLANK
  349. To disable the screen saver function, use the word NOBLANK in your
  350. command line options.  This parameter will also disable the manual
  351. screen blanking (boss key), since both are really the same function.
  352.  
  353. NOANIMATION
  354. If your computer or video card is too slow to display the animation
  355. (movement) of the cards, use this option from the command line.
  356.  
  357. LAPTOP
  358. If you have a monochrome monitor, like on most LCD laptops, and you
  359. aren't using a mouse, the switch LAPTOP will use a brighter shade for
  360. the highlighted letters to make them easier to see.
  361.  
  362. PAUSE
  363. If you want the dialogue boxes not to dissappear after the 5 second wait
  364. so that you can look at the point counting of the hands, use the PAUSE
  365. command line switch.  This may help when trying to learn how to count
  366. the points for beginners.
  367.  
  368. NOKEYBOARD
  369. This option will disable all keyboard input for the game except for when
  370. changing the player name in the options menu.  This option will only work
  371. if there is a mouse detected, otherwise what's the point.
  372.  
  373. GO
  374. To go directly into the game, bypassing the intro screen, use the
  375. command GO from the DOS prompt.  Example: CRIBBAGE John B:\ go
  376.  
  377. If you want to have the configuration and save files read and saved
  378. from or to a different drive or directory, you may specify a file path
  379. on the command line.  Valid paths must start with a backslash (\)
  380. or a drive letter and colon (B:) or parent directory dots (..) 
  381. Valid path examples are:
  382.   CRIBBAGE A:
  383.   CRIBBAGE \GAMES\MYSAVE
  384.   CRIBBAGE D:\WORK\
  385.   CRIBBAGE \
  386.   CRIBBAGE ..
  387.   CRIBBAGE ..\STUFF
  388. If just the drive letter is given, then the current path is used on
  389. that drive. (meaning if you are in D:\GAMES and then change to drive C:
  390. and run "CRIBBAGE D:" then your game files will be saved in D:\GAMES.
  391. If a path is given, it is tested at game startup, and if it is invalid
  392. for any reason, the current directory will be made the default path.
  393. As always, if a path not is specified, the current directory is used.
  394.  
  395. Since the game looks only at the first eight parameters given, too
  396. much garbage on the command line might miss a legitimate option.
  397. Example: CRIBBAGE 1 2 3 4 5 6 7 8 GO will NOT execute the GO command.
  398.  
  399. These options can be put in any order and are all case INsensitive
  400. except for the Player Name.
  401.  
  402.  
  403. ======================================================================
  404. This SHAREWARE program is written in Turbo Pascal Version 7.0
  405.  
  406. The Mouse unit is from the book "Turbo Pascal Advanced Programmer's
  407. Guide" by Stephen K. O'Brian.  This unit was slightly modified by me.
  408.  
  409. Please feel free to call or write to me if you have any questions, 
  410. comments, improvements, or find any bugs.  
  411.  
  412. If you like this program and want to support the efforts of a shareware 
  413. programmer, please send cash or check for any amount that you feel my
  414. Cribbage game is worth to you to:
  415.  
  416. David Teach
  417. 12708 Bruce B. Downs Blvd. #216
  418. Tampa, FL  33612
  419.  
  420. Phone: (813) 975-1099
  421. CompuServe ID: 70743,2753
  422. E-mail: d.teach@ix.netcom.com
  423. Homepage: http://ourworld.compuserve.com/homepages/dteach
  424.  
  425. If you send in the registration fee for CRIBBAGE, I will mail to you my
  426. latest version and will also give you my other card game, GINRUMMY.
  427.  
  428. By default, I send out 3.5 disks, if you need 5.25 please specify so.
  429.  
  430. When writing to me please tell me where you obtained Cribbage, and be
  431. sure to include the version number of the game that you currently have.
  432.  
  433. ======================================================================
  434.  
  435. What is Shareware Software?
  436.  
  437. Shareware, or user-supported software, is a popular way of marketing
  438. software for the program's author.  Shareware software is copyrighted.
  439. The authors encourage you copy their software and share it with friends.
  440.  
  441. If you like the program and continue using it, you should send in the
  442. "registration fee".  This is a wonderful deal for the consumer.  If you
  443. try a program and don't like it, you owe the author nothing.
  444.  
  445. However, if you find you are using the program, then it is only right
  446. to pay the "registration fee" which usually ranges from $5.00 to $50.00
  447. depending on the program.  Please support these authors.  They have
  448. worked hard to give you their products and can only do so in the future
  449. if you encourage them.  Shareware software will then continue to flourish
  450. and everyone will benefit.  Where else can you "TRY BEFORE YOU BUY".
  451.  
  452. =========================================================================
  453.  
  454. Version History:
  455.  
  456.      Version 2.0 - 01/03/96 - (card animations, other misc. stuff)
  457.        - added animation (movement) of the cards when drawing and
  458.            discarding using a variable timing routine.
  459.        - fixed a longtime bug in the statistics saving where if you
  460.            changed your name to another name in the list that was not
  461.            the first, it would overwrite the first name with the new one.
  462.  
  463.      Version 1.9 - 11/02/94 - (new address, removed card backs file)
  464.        - changed the registration address again, my phone number is the
  465.            same though.
  466.        - removed the graphic file for the card backs until I can do
  467.            a better job drawing and implementing them.  If you REALLY
  468.            liked them, let me know and I'll put them back in later.
  469.        - put in requested NOKEYBOARD "baby switch" that will disable
  470.            most keyboard input during play and use the mouse only.
  471.  
  472.      Version 1.8 - 05/10/94 - (variable card backs, pause boxes)
  473.        - added the ability to read the pattern of the card backs from
  474.            a random spot on a 640x350x16 pcx file, if present.
  475.        - added the PAUSE option to not remove the score boxes after
  476.            the usual 5 second wait so you can see the points better.
  477.        - fixed a few small screen junk bugs.
  478.  
  479.      Version 1.7 - 03/04/94 - (heels, 5 card 15)
  480.        - when the starter is a jack, it now says correctlly says
  481.            "heels" instead of "nobs" when scoring.
  482.        - fixed a bug that did not count all five cards for fifteen 
  483.            scoring.
  484.  
  485.      Version 1.6 - 02/10/94 - (another bug fix, executable stuff)
  486.        - added a box that shows the scores after each hand played.
  487.        - changed the CRC error checking routine to be more accurate.
  488.        - greatly reduced the size of the executable file.
  489.        - fixed a bug that didn't allow the screen blanker to work if
  490.            you had less than four cards in your hand.
  491.  
  492.      Version 1.5 - 01/06/94 - (quick bug fixes)
  493.        - the new NODISK option was accidentally defaulted to TRUE,
  494.            thereby no options or statistics could be saved or loaded.
  495.        - fixed a bug that didn't allow keyboard play after using the
  496.            mouse to cancel a command selection.
  497.  
  498.      Version 1.4 - 11/10/93 - (keyboard and mouse together, nodisk)
  499.        - all keyboard keys now work when using a mouse so that you
  500.            can now play with mixed controls.
  501.        - replaced KEYBOARD command line option with the NODISK option.
  502.        - added the VIEW command line option to view the documentaion file.
  503.  
  504.      Version 1.3 - 09/22/93 - (Hercules improvements, mouse page two)
  505.        - finally fixed the program so that the mouse can be used on
  506.            Hercules and MDA graphics systems.
  507.        - changed the NOBLANK option as workaround for people who cannot
  508.            access their mouse in the Options, High Scores, or Statistics
  509.            screens.  It now eliminates all video paging.
  510.        - fixed a bug that did not put the +/- sign in the options menu
  511.            when using Hercules graphics and the keyboard.
  512.  
  513.      Version 1.2 - 06/25/93 - (better formulas, stats, new address)
  514.        - improved the formulas when choosing cards to discard that take
  515.            into consideration which player is holding the crib.
  516.        - changed stats to separately track the average number of points
  517.            in your hand and crib, and got rid of average hands per game.
  518.        - moved the mouse pointer away from the middle of the screen when
  519.            starting a new game to not block the box that says who deals.
  520.        - enhanced the logic when choosing a card to play for the hints
  521.            and for the computer player.
  522.        - fixed a bug that sometimes did not end a hand after all of the
  523.            cards were played.
  524.        - corrected an error which sometimes waited a turn before ending
  525.            a game when the human player pegged the last hole for a win.
  526.        - added CRC checksum self-validation of the executable file to
  527.            catch possible virus, hacking, or file corruption errors.
  528.        - changed my address and phone number for those who want to
  529.            register or have questions.
  530.  
  531.      Version 1.1 - 03/30/93 - (a few quick fixes)
  532.        - fixed a minor bug that indented the cards incorrectly when the
  533.            dealer went next after a 'GO' was called.
  534.        - corrected a few spelling errors in the program and in the
  535.            documentation.
  536.        - changed some of the screen layout and colors.
  537.  
  538.      Version 1.0 - 03/29/93 - (initial release)
  539.        - converted my GinRummy (4.1) card game to Cribbage.
  540.